endpoint
-Specific Update Requests
Celebrity Update Requests
All endpoints follow the basic update process described in General Update Process. You can retrieve Celebrity updates using updateId
in the request:
- updateId - Unique update token, used to retrieve celebrities since specific update point. It can be combined with limit to ingest specified batch size.
- personId - Unique celebrity identifier. To be used for evaluation and troubleshooting purposes, not programmatic ingestion
Programs Update Requests
You can retrieve Programs updates using:
- updateId - Unique update token, used to retrieve programs since specific update point. It can be combined with limit to ingest specified batch size
- tmsId - Retrieve specific program records. To be used for evaluation and troubleshooting purposes, not programmatic ingestion
When requesting updates, the most recent version of a program is returned. Updates are not 'replayed' as a log of changes. For example, if a program is added, modified once, and then modified again, the next call for updates includes the program only once in the response, with latest updateId
. updateIds in a response are not consecutive, although programs are sorted by updateId
.
Note: In v3/Programs, updateId
applies to a TMSId-specific version, so multiple TMSIds with same rootId (language variations of same program) will each be marked with unique updateIds.